home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / tw14w12b.zoo / tw14w12 / wwa_ext.doc < prev   
Text File  |  1994-05-06  |  5KB  |  128 lines
  1.  
  2.                              TOSWIN WWA Extension
  3.                              --------------------
  4.                     by Warwick Allison (warwick@cs.uq.oz.au)
  5.                          (TOSWIN v1.4, extensions v1.2)
  6.  
  7.  
  8.    Summary:
  9.  
  10.      1. GEM RUN         = Run 1 GEM program from within TOSWIN.
  11.      2. X SELECT        = X Window System Xterm-style cut & paste.
  12.      3. AUTO RAISE      = Windows are optionally TOPPED when point-to-type.
  13.      4. INITIAL REDRAW  = Screen redraw done at start-up (not with MultiTOS).
  14.      5. BETTER TOSRUN   = Open text windows from commandline with any
  15.                            font, position, and size; use TOSWIN for
  16.                            TOS and TTP programs run from the Desktop.
  17.  
  18. -----------------------------------------------------------------------------
  19.  
  20.    1. GEM RUN
  21.  
  22.          The RUNTOS and TOSWIN programs are modified so that 1 GEM program
  23.          may be invoked from within TOSWIN when running as an application.
  24.  
  25.          This is only useful to users running MiNT from the desktop with
  26.          TOSWIN as the INIT program.
  27.  
  28.          To invoke a GEM program from within a TOSWIN window, use:
  29.  
  30.                runtos -g someprog.prg arg1 arg2 arg3 ...
  31.  
  32.          To invoke a TOS program in a window from within a TOSWIN window, use:
  33.  
  34.                runtos someprog.tos arg1 arg2 arg3 ...
  35.  
  36.          ...as before.  
  37.  
  38.          This is often useful, for example if you are developing a GEM program
  39.          and want to run it, or if you use a GEM program for displaying or
  40.          manipulating the TOS files you are developing (eg. DVI_WIND for
  41.          viewing LaTeX DVI output, running a RSC editor).
  42.  
  43.  
  44.    2. X SELECT
  45.  
  46.          The XTerm cut & paste technique is very quick to use:
  47.  
  48.               - Click and drag to highlight a region (as normal TOSWIN).
  49.               - Double-click to select a whole "word" of text.
  50.               - Triple-click to select a whole line of text.
  51.               - Right-click to paste last selected text.
  52.  
  53.  
  54.          Currently, a "word" is hard-wired to mean:
  55.  
  56.               Any sequence of alphanumeric characters or the
  57.                characters "/", ".", "_", or "@".
  58.  
  59.            or Any sequence of whitespace.
  60.  
  61.            or Any sequence of all the same character.
  62.  
  63.          So for example, "warwick@cs.uq.oz.au" could be highlighted with
  64.          a double-click, as could "      ", "========", "/mint/lib".
  65.  
  66.          To change the hard-wired definition of "word", edit the
  67.          CharClass function in "util.c" of the source code.
  68.  
  69.  
  70.    3. AUTO RAISE
  71.  
  72.          Windows are automatically raised to the top when the mouse
  73.          enters them (provided Point to Type is also enabled).
  74.  
  75.          This is another feature that can often be configured on the
  76.          X Window System.
  77.  
  78.          Personally, I find it a pain in the neck under X, however, it
  79.          is very useful in TOSWIN because under GEM, you cannot drag
  80.          or double-click on a window (ie. do all that cut&paste stuff)
  81.          unless it is the TOP window.
  82.  
  83.  
  84.    4. INITIAL REDRAW
  85.  
  86.          When running TOSWIN from the desktop, the MiNT copyright message
  87.          and eXtended File System messages mess up the screen.  This
  88.          extension merely does a screen redraw when TOSWIN initializes.
  89.  
  90.  
  91.    5. BETTER TOSRUN
  92.  
  93.          In addition to the original feature of being able to open test
  94.          windows from the command line via:
  95.  
  96.              runtos someprog.tos arg1 arg2 arg3 ...
  97.  
  98.          You can now set the initial position and size:
  99.  
  100.              runtos -w x y w h someprog.tos arg1 arg2 arg3 ...
  101.  
  102.          and/or the initial font:
  103.  
  104.              runtos -f fontname fontsize someprog.tos arg1 arg2 arg3 ...
  105.  
  106.          -w and -f can be used at same time, but no use with the -g option
  107.          described under "GEM RUN" above.
  108.  
  109.          Finally, if RUNTOS cannot find the pipe through which it talks
  110.          to TOSWIN, it attempts to execute TOSWIN_W.PRG or TOSWIN.PRG on
  111.          the $PATH variable.
  112.  
  113.          To use this feature under MultiTOS, edit your GEM.CNF file so that
  114.          the directory containing TOSWIN_W.PRG is on the PATH, and so that
  115.          RUNTOS.PRG is used to run TOS and TTP programs, thus:
  116.  
  117.             setenv PATH=.,F:\MULTITOS,F:\MULTITOS\TOSWIN
  118.             setenv TOSEXT=TOS,TTP
  119.             setenv TOSRUN=F:\MULTITOS\TOSWIN\RUNTOS.PRG
  120.  
  121.   
  122.    ALSO...
  123.  
  124.          These extensions contain a number of bug fixes from the Net and
  125.          found during the extension implementation.
  126.  
  127. -----------------------------------------------------------------------------
  128.